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Today, we are going to use the tools we developed last 
time to write a slightly larger application that uses mul- 
tiple methods. 

Our task will be to write a program that can print a 
backslash using asterisks: 


The user will input a height, and then a backslash of 
that height will be printed. For example, the height of 
the above backslash is 6. 


Breaking down the task 


What we need to do is decide what parts of the task to 
organize into separate methods. There is not necessarily a 
“right answer” to this question. Some choices are clearly 
better than others, and the more programming experience 
you gain, the better sense you will have of which choices 
for program organization make sense and which don’t. 
Some of it, though, comes down to individual style as 
well. And, sometimes the goal is an educational one — the 
code we are about to write could probably all go inside 
main() without too much trouble, but as we are trying 
to teach methods, we will organize our work so that three 
additional methods are needed. 








Since we need to read in the height of our backslash and 
then draw the backslash, one logical way to break up the 
work is to have one method for reading in the height from 
the user, and another method for drawing the backslash. 
This way, the first method has one complete task to worry 
about — namely, input — and the second method has its 
own complete task to worry about — namely, drawing 
the shape. We will call these methods GetHeight and 
DrawShape, respectively. 


In addition, notice that the backslash is really made up 
of lines that are rather similar. Each line has a number of 
spaces followed by a single asterisk. The number of spaces 
before the asterisk varies, of course, but each line follows 
the same basic idea — some number of spaces is printed, 
and then an asterisk. So, we can probably isolate that 
idea into a separate method, called DrawLine, and then 
when we write DrawShape, we will make use of DrawLine 
to assist us, by noting that repeated calls to DrawLine 
will accomplish the drawing of the shape. 


The GetHeight method 


In order to write this method, we need to decide what 
return type we want and what parameters we need. 





e For the return type, the question is, “what is the type 
of the value we hope to return?” ‘This method is sup- 
posed to obtain a height value and send it back to the 
main() method. Clearly, the height will be an integer 
—an integral number of lines. You can’t have ’C’ lines 
or 2.3 lines. So, the return type must be int. 


e For the parameters, the question is, “what data does 
this method need ahead of time in order to do its job?” 
And the answer here is, none! If we were perhaps 
drawing different shapes, then we might want to know 
which shape is to be drawn so that we can read in 
appropriate input for that shape. But, in this case, 
there is only one shape, we are always going to want 
to read in just the height, and so we can go ahead and 
do that — there is no “starting information” we need 
from main() in order to accomplish this task. So, the 
parameter list is empty. 


And thus, the first line of the method is: 
int GetHeight () 





As far as the rest of the code goes, that is relatively 
straightforward. We are simply going to prompt the user 
for input and then obtain that input. 


int GetHeight () 


{ 
int height ; 
System.out.println("Enter height:") ; 
height = Keyboard.readInt() ; 

t 





Of course, we are still missing something. Remember, 
whenever we have a return type that is not void, we 
need an explicit return statement that indicates what 
needs to be returned. So, the full correct version of the 
GetHeight () method would be: 





int GetHeight () 

{ 
int height ; 
System.out.println("Enter height:") ; 
height = Keyboard.readInt() ; 
return height ; 


We could also have avoided declaring the height variable 
by returning the input directly. Remember that return 
should be followed by an expression. Above, that expres- 
sion is the single variable height, which gets evaluated to 
the value stored in height. You could also have followed 
the return with the expression Keyboard.readInt (), 
which gets evaluated to the value sent in by the user. 


int GetHeight () 

{ 
System.out.println("Enter height:") ; 
return Keyboard.readInt () ; 


} 


Now, doing the above would make it impossible to check 
if the input was in a certain range or not, since we have 
not stored it in a variable but instead are returning it as 
soon as we recieve it. And it mixes input in with the 
return statement, which might be considered poor style 
or unclear to some. But perhaps not to others — and 
it uses less code. So, there are positives and negatives 
to this approach. The important thing to be aware of is 
that method calls to methods with non-void return types 
are expressions and thus can indeed be part of a return 
statement. 


Using GetHeight in main(). 


We will start off main() by obtaining the input value 
from GetHeight () and storing it in a local variable. 


public class Program 
ae 
public static void main(String[] args) 
{ 
int height ; 
height = GetHeight(); 


Note that we are using height as a variable here, and 
we also used height as a variable in GetHeight (). ‘This 
is not a problem, due to our scope rules. Each variable 
is accessible only in the method it was declared in, and 
so since GetHeight() cannot access main()’s height 
variable, there would be no confusion if GetHeight () 
declared its own height variable. When that variable 
is used in GetHeight(), we know it is not main()’s 
height variable we are referring to, because that would 
not be allowed. So, it must be GetHeight ()’s height 
variable we are referring to. 








We can think of the first height as “main’s height” 
and the second as “GetHeight ()’s height”. If you view 
things that way, associating (in your mind) each variable 
name with the method call it was declared in, then that 
will tend to eliminate any naming confusion you might 
have in your own mind. Just view the full name of a 
variable as consisting of not just the variable name, but 
also the method call that variable was declared in. 


Incidentally, that means that we could use the same 
variable name in every single method in a program if we 
wanted to. And, in fact, a variable name such as i, which 
is often the counter variable we use in a for-loop, actually 
does get used in many of the methods in a program. That 
is not any kind of a problem whatsoever — each i is part 
of a different method call and thus each i is distinct. 


The DrawLine method 


This method is going to print a certain number of spaces, 
followed by an asterisk. Again, we ask our two questions: 


e return type — “what is the type of value we hope to 
return?” ‘This method will draw things to the screen, 
but much like System.out.println, it doesn’t ac- 
tually generate any calculation results that need to be 
sent back. It is merely a method that does work; it 
doesn’t actually have any value to return. Thus, our 
return type should be void, to indicate that nothing 
is actually returned. 


e parameters — “what data does this method need ahead 
of time in order to do its job?” It would seem here 
that we can’t properly draw the line unless we know 
how many spaces we want. ‘That number of spaces can 
vary, so it makes the most sense to have the user of the 
method pass in the number of spaces, and then that 
number of spaces can be printed before the asterisk. 





So, the first line of our method should be: 


void DrawLine(int numSpaces) 


In order to actually write the code, we need a way to be 
able to print out a particular number of spaces. When this 
method is called, that number of spaces will be known — 
it will have been passed as an argument and stored in the 
parameter for this method — and so since that parameter 
will tell us exactly how many spaces we want, we should 
use a for-loop to repeat the work of printing spaces, since 
a for-loop is a good choice for situations where we know 
exactly how many times we want the body of the loop to 
be run. 


void DrawLine(int numSpaces) 


{ 
int i; 
for (i = 1; i <= numSpaces; i++) 
System.out.print(" "); 
System. out.printin("*") ; 
t 


Note that if we don’t want any spaces to be printed, this 
method can handle that too. In that case, numSpaces 
will be 0. The for-loop will first initialize i to be 1, 
and then will compare i to numSpaces as the condition 
indicates. The condition will be false — 1 is certainly not 
less than or equal to 0 — and so we will exit the loop 
immediately, before ever running the body of the loop 
even once. 


The DrawShape() method 


This method is going to print a certain number of lines, 
with each line containing an asterisk at the end of the 
line, and each line containing one more space before the 
asterisk than the line before it. The first line will have 
no spaces at all before the asterisk. Given those require- 
ments, again we must ask our two questions: 








e return type — “what is the type of value we hope 
to return?” ‘This method will draw things to the 
screen, but again — just like System.out.printin 
or DrawLine, it won't actually generate any calcula- 
tion results that need to be sent back. So — as with 
DrawLine — our return type should be void. 


e parameters — “what data does this method need ahead 
of time in order to do its job?” It would seem here that 
we can’t properly draw the backslash unless we know 
how many lines that backslash will have — that is, we 
need to know the height of the backslash. Each indi- 
vidual line can be drawn using the DrawLine method, 
but we need to know how many individual lines to 
draw. Since we read in that value elsewhere in our 
program, it makes sense to pass it to this method via 
a parameter. 


So, the first line of our method should be: 
void DrawShape(int height) 
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For the rest of the code, well, we will proceed here in 
much the same way as we did for DrawLine. We know 
what work we want repeated; in DrawLine it was the 
printing of a space, and here it is the printing of a line. We 
also know how many times we want that work repeated; 
in DrawLine it was equal to the number of spaces we 
wanted, and here it is equal to the number of lines we 
want — i.e. the height that we passed in as an argument 
to the method and now store in a parameter. 

So, it would follow that we should again use a for-loop: 


void DrawShape(int height) 


{ 
int i; 
for (i = 1; i <= height; i++) 
// some code here 
is 


We are going to do something height times. But what? 
Well, we want to draw a line that many separate times, 
so it follows that we should invoke the DrawLine method 
as the work inside the body of the loop. 


void DrawShape(int height) 


{ 
int i; 
for (i = 1; i <= height; i++) 
DrawLine(???7) ; 
7 


It is perfectly okay to do that (we need an argument, 
of course, which we'll choose in just a bit). We need 
at least one statement as the body of our loop, but the 
call to DrawLine is a statement. Every method call is 
a statement. Some are also expressions — specifically, the 
ones with return types are expressions. But every method 
call is a stand-alone statement as well. For example, the 
following: 





public class Ignore 


{ 
public static void main(String|] args) 
< 
Keyboard.readInt() ; 
t 
t 


is perfectly legal code. If you run it, the program will 
input a value which it will promptly ignore, and the pro- 
gram will end. Now, normally we don’t want to ignore 
values returned by methods...but the point is that you 
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can. The method can be called regardless of whether you 
use its return type or not. 

Of course, in the case of methods with a return type 
of void, there is no return type at all to make use of. 
So, we can only use calls to those methods as statements, 
not as an expression in a larger statement (such as an 
assignment statement). With DrawLine, though, that is 
all we need. We are simply saying that, for the work done 
by one pass through this for-loop, we want to run a call 
to DrawLine. 


We need a single argument of type int for the method 
call, of course, since DrawLine has a single parameter of 
type int. Since this argument should be the number of 
spaces we want before the asterisk on our line, and since 
the first line should have zero such spaces, the next line 
one such space, the next line two, and so on, it would 
appear that subtracting 1 from i will give us the number 
of spaces we want. 


void DrawShape(int height) 
{ 
int i; 
for (i = 1; i <= height; i++) 
DrawLine(i-1) ; 


That is, numbering the lines starting at 1, the number 
of spaces we want on a line is always one fewer than the 
line number — line 1 has 0 spaces before the asterisk, line 2 
has 1 space before the asterisk, line 3 has 2 spaces before 
the asterisk, and so on. 

Notice that having expressions as method arguments is 
perfectly legal. Previously, we have used only literals and 
variables, but the point is to use a value of some kind. 
Literals are values, and variables hold values; likewise, a 
more complex expression still evaluates to a single value, 
so a more complex expression will work as a method argu- 
ment as well. Above, the expression i-1 will be evaluated 
before its resultant value is sent to the DrawLine method 
call. In fact, if you have a method with many parameters, 
and thus are passing many arguments to it, and if those 
arguments are all complex expressions, then each of those 
expressions will be evaluated to its single value before the 
method call is actually initiated. 

This only makes sense — after all, you can’t very well use 
the argument values if you haven’t figured out what they 
are yet — but I thought I would make it clear that, yes, 
that is indeed how the language works. Method argument 
values are always obtained — even if this means evaluating 
an expression — before the work is done to initiate the 
actual method call. 

















Finally, we might notice that there is an extra sub- 
traction we are performing each time through this loop 
that we might be able to avoid. If the line numbers were 
treated as being 0 through height - 1 instead of being 
1 through height, then the number of spaces we want 
before the asterisk on a line would correspond exactly to 
the number of that line. Then the subtraction of 1 from 
the line number to get the number of spaces on that line 
would not be necessary. We can rewrite our code to make 
use of this idea as follows: 


void DrawShape(int height) 


at 
int i; 
for (i = 0; i <= height-1; i++) 
DrawLine (i); 
} 


Now we have avoided running a subtraction inside the 
body of the loop each time, but we will need to subtract 
1 from height each time we run the comparison! So, it 
would seem we still have many subtractions to do. But, 
we can avoid the new subtraction entirely, by choosing a 
different comparison, namely, by checking if we are less 
than height, rather than less than or equal to 

height —- tf: 


void DrawShape(int height) 


a 
int i; 
for (i = 0; i < height; i++) 
DrawLine (i); 
I; 


All three of the different ways to write this method (sub- 
traction in method argument, subtraction in comparison, 
no subtraction) work correctly, and none of them is nec- 
essarily much clearer than another. So, this last version 
is probably the best to use. 


Note that this would not be the case if we had to print 
the line numbers 1...height in our diagram. In that 
case, having i range from 0...height - 1 instead of 
1...height would mean adding an addition to get the 
proper line number, and with the removal of a subtraction 
but the including of an addition, we’d be back where we 
started (subtraction and addition take basically the same 
amount of time). But, that was not the case here, so we 
were able to rearrange our code slightly to remove the 
cost of the subtraction and thus make our method run 
faster. 


In this class, we will not be tremendously focused on op- 
timizing code as we did above; since this course is taught 
from a beginner’s standpoint, our focus will be more just 
on teaching you to just write code that works and is 
reasonably well-organized! But writing efficient code is 
important too, and issues like those above are ones you 
should be giving some thought to as you learn the var- 
ious program design and analysis principles we will be 
discussing this semester. 





One final note — notice that i is used as a variable in 
both DrawLine and DrawShape. As we have already 
discussed, this is not a problem because it is clear from 
the method you are in which i you are referring to. 


Completing main () 


So, finally, we now have the drawing code completed 
and all that remains is to invoke the DrawShape method 
from main(). Recall that we already had read in the 
height of the backslash and stored it in a variable: 


public static void main(String[] args) 
{ 

int height ; 

height = GetHeight(); 

// more? 


} 


The DrawShape method wants as its single argument the 
height of the backslash. So, we should pass in our height 
variable as the argument to DrawShape; 


public static void main(String[] args) 
{ 

int height ; 

height = GetHeight(); 

DrawShape (height) ; 
t 


Note that it is not necessary to have any assignment state- 
ment when using this method. DrawShape returns void, 
so there is no value to write into a variable. We simply 
invoke the method, and certain work gets done as a result 
— just as when we invoke System.out.println. 
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Note that — in keeping with the idea of method-as- 
expression — it should be possible to avoid declaring the 
height variable by simply having the GetHeight call as 
the argument to DrawShape: 


public static void main(String[] args) 
{ 

DrawShape (GetHeight () ) ; 
t 


Remember, the argument always gets evaluated before 
the method call using that argument is activated. So, 
above, the expression GetHeight — a method call that 
returns an integer — is evaluated to produce the input in- 
teger, and then that inputted integer is sent in as the argu- 
ment to DrawShape, which is called after the method-call 
argument GetHeight is evaluated. 

However, in terms of program clarity, we might often 
prefer not to use input statements in the above manner. 
That is largely a manner of style. I personally don’t care 
for the readability of the above approach, but you might 
not have a problem with it, and it does eliminate the 
need for a variable in memory and also saves a bit of time 
(no assignment into height is needed, for example). The 
choice is yours, and as always, is dependent on experience, 
personal style, and the circumstances surrounding your 
program. For example, in some situations, optimizing 
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every last millisecond out of your code that you can takes 
precedence over everything else, so you wouldn't really 
have a choice in such a circumstance — the time-saving 
choice would be the necessary one to make. In other 
circumstances, there might be a more flexible tradeoff 
between readability and time and/or memory efficiency. 











The final program 


public class Program 


if 


public static void main(String[] args) 
{ 

int height ; 

height = GetHeight(); 

DrawShape (height) ; 
t 


public static int GetHeight () 

{ 
int height ; 
System.out.println("Enter height:") ; 
height = Keyboard.readInt() ; 
return height ; 


} 


public static void DrawShape(int height) 
{ 
int i; 
for (i = 0; i < height; it+) 
DrawLine (i) ; 


public static void DrawLine(int numSpaces) 
{ 
int i; 
for (i = 1; i <= numSpaces; i++) 
System.out.print(" "); 
System.out.println("*") ; 


Using methods from other classes 


In the program above, all of the methods were inside 
the same class, Program. So, any of the methods could 
invoke any of the other methods just by using the name of 
that method. It is assumed in the absence of any further 
information that you are talking about the method with 
that name from the class you are in. 


If you want to use methods from another class inside 
the class you are in, you must list the class name with the 
method name, so that the system knows in which class to 
find the method you want. This is done via the following 
syntax: 


className.methodName(arg1,...,argN); 


That is, you list the class, followed by a “dot”, followed 
by the method call as usual. ‘This is the idea behind 
the call to Keyboard.readInt() — the method is called 
readInt() (you will find it if you look inside the 
Keyboard. java file), and since it is in the class Keyboard, 
you access it by listing the class (Keyboard), followed by 
a dot, followed by the method name (readInt). 





This same principle works for methods in any other 
classes as well. Therefore, it is helpful to group a num- 
ber of common methods in the same class. As we have 
said earlier, our first view of a class (we will gain a more 
detailed view in about a week) is as a “box” that can 
store helpful stuff. Specifically in this case, a class holds 
a bunch of helpful related methods. The class Keyboard 
holds many helpful input methods, and other classes can 
hold other collections of helpful methods. 


For example, the class Math is built into the language 
— that is, unlike Keyboard, you don’t need to include the 
file yourself, but rather it and its methods are already 
there for your use. The Math class holds a number of 
helpful mathematical functions, such as 


e double sqrt(double x) — returns square root of x 
e double cos(double x) — returns cosine of x 


e double abs(double x) —returns the absolute value 
of x 


So, for example, if you had a variable in your code of 
type double called value in your code, and you wanted 
to store its square root in the variable of type double 
called result, you would use the line of code: 





result = Math.sqrt (value) ; 
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Again, the syntax is to first list the class (Math), followed 
by a dot, followed by the method name (sqrt). 


Appendix C in your textbook (KMR)) lists all the meth- 
ods in the Math class. There are other classes in the lan- 
guage with methods you can use in this way as well...and 
of course, you can always write your own classes that add 
additional methods, just as the authors of your textbook 
wrote the Keyboard class in order to add helpful key- 
board input methods to the collection of methods you 
can use. 


